###User Defined Function###
_Excel_BookOpenText

###Description###
Öffnet eine Textdatei und übersetzt den Inhalt zu einem neuen Arbeitsbuch mit einer einzigen Seite

###Syntax###
#include <Excel.au3>
_Excel_BookOpenText ( $oExcel, $sFilePath [, $iStartRow = 1 [, $iDataType = Default [, $sTextQualifier = $xlTextQualifierDoubleQuote [, $bConsecutiveDelimiter = False [, $sDelimiter = "," [, $aFieldInfo = "" [, $sDecimalSeparator = Default [, $sThousandsSeparator = Default [, $bTrailingMinusNumbers = True [, $iOrigin = Default]]]]]]]]]] )

###Parameters###
@@ParamTable@@
$oExcel
	Excel Programm Objekt, wo das neue Arbeitsbuch geöffnet werden soll
$sFilePath
	Pfad und Dateiname der Datei die geöffnet werden soll
$iStartRow
	[optional] Die Zeile an der das übersetzen der Datei beginnen soll (standart = 1)
$iDataType
	[optional] Definiert das Spaltenformat der Daten in der Datei. Kann irgendeine der XlTextParsingType Aufzählung sein.
		Wenn auf das Schlüsselwort Default gesetzt wurde, versucht Excel das Spaltenformat gerauszufinden (standart = Schlüsselwort Default)
$sTextQualifier
	[optional] 
	[optional] Legt den Text Kennzeichner fest (standart = $xlTextQualifierDoubleQuote)
$bConsecutiveDelimiter
	[optional] True 
	[optional] True wird aufeinanderfolgende Trennzeichen als ein Trennzeichen betrachten (standart = False)
$sDelimiter
	[optional] Ein oder mehr Zeichen die als Trennzeichen genutzt werden sollen (default = ",")
$aFieldInfo
	[optional] Ein Array, welches die übersetzten Informationen für verschiedene Spalten mit Daten beinhaltet.
		Die Interpretation hängt von dem Wert in $iDataType ab.
		Wenn die Daten getrennt werden, ist dieses Argument ein Array von zwei-element Arrays, welche jeweils ein zwei-element Array sind
		welche die Umwandlungsoptionen für eine spezielle Spalte festlegt.
		Das erste Element ist die Spalten Nummer (1-basiert), und das zweite Element ist eines der XlColumnDataType
		Konstanten, die festlegt, wie die Spalte übersetzt wird (standart = Schlüsselwort Default)
$sDecimalSeparator
	[optional] Dezimaler Trenner, den Excel nutzt um Zahlen zu erkennen.
		Standarteinstellung ist die Systemeinstellung (Standart = Schlüsselwort Default)
$sThousandsSeparator
	[optional] Tausender Trennzeichen, welches Excel nutzt um Zahlen zu erkennen.
		Standarteinstellung ist die Systemeinstellung (Standart = Schlüsselwort Default)
$bTrailingMinusNumbers
	[optional] 
	[optional] True behandelt Zahlen mit einem Minuszeichen am Ende als negative Zahlen.
		False behandelt solche Zahlen als Text (Standard = True)
$iOrigin
	[optional] Herkunft der Textdatei. Kann eine der XlPlatform Konstanten sein.
		Zusätzlich kann dies eine Zahl sein, welche die code page number der gewünschten Code Page darstellt.
		Zum Beispiel, "1256" würde als Kodierung Arabisch (Windows) festlegen.
		Wenn dieses Argument ausgelassen wird, nutzt die Methode die aktuelle Einstellung der Dateiherkunft in dem Text Import Wizard.
@@End@@

###ReturnValue###
@@ReturnTable@@
Success:	 Ein Arbeitsbuch Objekt.
Failure:	0 und setzt @error.
@error:	1: $oExcel ist kein Objekt oder Programm Objekt
	2: Angegebener $sFilePatch existiert nicht
	3: Es ist nicht möglich $sFilePath zu übersetzten. @extended ist gesetzt auf den COM error code zurückgegeben von der OpenText Methode
@@End@@

###Remarks###
Der Parameter $aFieldInfo muss ein Array sein, dass Arrays beinhaltet, kein 2D Array. Bitte siehe Beispiel 2.

###Related###
_Excel_BookAttach, _Excel_BookClose, _Excel_BookNew, _Excel_BookOpen

###Example###
@@IncludeExample@@
